Mission Description | 


_.. Data Management © Oe 
, Global Data Management. 
SECTION I 
GLOBAL DATA MANAGEMENT DOMAIN 
1.0 General Description : 
The Globat Data Management Domain is a centralized system 
shared component of GC0S66 which performs global data man- 
agement functionss such as. opening and closing filess which 
apply to all access methods. 
The functions included in this component ares: | 
| ; ee er ae eer ce ea | = 
Te The Create Buffer Pool function creates and initializes 
a buffer pool with -the input size and sharability 
attributes. The buffer pool can be referenced by a 12 
character ASCII name. | 
Ce The Detete Buffer . Pool. function deletes the buffer 
pool with the specified. name. | 
3e The Reserve File function is called during file altloca- 


tion. <A shared fite structure is created ands if the 
file is under concurrent. access controls a Resource 
Control S8tock is. associated with the file and it is 
enqueued on behalf of the requesting process. 


Le The Remove File function is performed during file 
| deallocation.j The Resource Control Block associated 
with the file is dequeuved for the requesting process 
ands if this is the last user of the files the Resource 


Control Block and the shared file structure are 
> The Open function creates and initializes a File Access 


Domain for the requested access method. Thus the file 
may be opened for access: by any. of the access methods: 
CIDOSs UFASs Buffer Managements... e)e An entry descrip- 
5 tor to the created File Access Domain is returned to 
oF the caller to permit access to the file through the 
access method domain. 
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The Close function terminates: the use of a File Access. 


Domain. The entry descriptor tothe File Access. Domain 


returned by the Open function 1s Pavel et Cds 
: f 


The RiecePve Bit tore. tone caod. se datended Poe use by the 


access methods themselves. Buffers for a file may be 


reserved either when the file is opened or deferred 


until the caller is prepared to access the filew When 


the tatter 3s desiredse this function. performs the res- 
ervation so tne the fite may be accessed. 


The. pemave utters. Ramiseian, removes ‘<he reservation af 


buffers for a fite or set of. files and returns the 


buffers to the ae ae List of Une buffer pool. 


The Global Plush: "Wane tseh: Ciiehee atl Surere fee alt 
the open fites. This function is normatly used at com 
mitment points. , 


The Globat Close function flushes the buffers and 
closes all the open files. This function is normally 
called at termination. 7 ) 


The. Si obet peeer. ea ini al function flushes the 


buffers for all open files and insures that each access 


method resets (ie. deletes) its. values of record. 


currencies and Pore currencies Cie. current Location 
in the file). 


The Global Suspend File Usage function is called when 


the Command Executive unmaps a tenant from a process. 
The files used by that process on behalf of the tenant 
are suspended. This. involves resetting the record and 
buffer currencies for each open file and also removing 
the buffers from the reservation tist. 


The Return File Information function returns attributes 


of the file and information about the usage of the 
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A, 2.0 Intecface to the Rata Management _Qomain 


The Data Management Domain is. entered via a CLIMB instruc 


tion with the function code selecting the particular func- 
tion to be called. . The first. parameter that its passed 
always. describes a command blocks other parameters may be 
required depending on the. function executed. A detailed 
description of the. parameters and definition of the command 
block is provided atong with the description of the individ= 
ual functions. 
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. Ze 4 putter Pool_ Functions 
2ete1 aufter_Pool Command Block. 4B2C8) 


The BPCB. is input to the Create and Delete Buffer Pool 
functions. | . 
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Figure 1.2-1. Buffer Pool Command Block 


BPLIMS Immediate status 
. 3PLORS Original status 
BP.BPN Buffer Pool Name (3 sonaes 
BP.MXB Maximum number of buffers tn pool 
BP.MNB Minimum. number of buffers in pool 
BP.TYP Buffer pool type (2 bits? bits 9-10) 
=00 public buffer pool. 
=01 private buffer pool 
BP.LLVL Buffer poot Level (¢7 bits) 
O process level 
1 work station level 
2 system tevet 
BP.B8SZ Buffer size tn words 
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os 2.122 Create -Sufter_fool_(Dcge.f) 
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This bane ion: creates a. putter pool with the specified 
sharability and size. The buffer poot. may be public (any 
file can be assigned to it) or private (only certains 


specified files can be assigned to it). The buffer pool 
will remain active until explicitly deleted by the Delete 
Buffer Pool function or until the working space in which it 
Resiees: is freed. 7 | 


Eormat 
ICLIMB DM.OPCon-DCBP.FrEAX 0 


where n = 1 if the buffer pool is public and 
n= 2 if the buffer pool is private 


Parameters 


- descriptor 0 : frames the Buffer Pool Command Block (BPCB) 


- descriptor 1 frames the private file list 
Buffer Pool. Command Block (8PCB) Parameters 
Loeut 7 
BP.BPN Name of the buffer pool to be created 
BP.MxXB Maximum number of buffers in pool 
BP.MNBS Minimum number of buffers in pool 
BPLTYP Buffer pool type (public or private) 


BP.LVL Buffer pool level (Cprocesss» workstation 


or system). 


BP.BSZ Buffer size in yowae 
BPLIMS. Immediate status 


BP.ORS Original status 


Status Codes 
af Buffer pool: already exists. 


Fite identifiers not input. for Priven file 


2 
3 Invalid buffer size 
4, 


One or more of the specified oe are already 


assigned to a different buffer pool 
Buffer space is not available 
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Euoction 


If the buffer poot name is. uniques the control 
structures which describe the buffer pool are 
created. Space is altowed for the pool to grow to 
reach the maximum number of buffers that was 
specified. The minimum number of buffers specified 
are created and initialized in the pool. 


If this is a. orivate. buffer poole file control 
structures for each of the input files 1s created 
and associated with the buffer pool. 


(A 20103 Delete Buffer Pool (D0B8P,F) 


This function deletes the buffer. pool with the specified 
name. ALt files. must have been "removed" that were 
associated with the buffer pool. : 
Format 
ICLIMB DOM, oPc.1 -008P. FPEAXO 
Parameters 
- decceietor 0: frames the Buffer Pool Command Block 
Buffer Pool Command Block (BPCB) Par ameters 
7 . 
Inout 
BP.BPN Buffer ee) name 7 | z an 
BP.LVL Butter pool tevel (opeeses: work stations system) 
BP.IMS Immediate status 
BP.ORS Original status 
| 
oH 
StatusCodes. 
- : Buffer pool not found 
=f ; One or more files still active 
ae) | Eyostion 2  ¢ | 
; The buffer pools are searched for a match on the 
input mame and a check made to insure that all files 
associated with the buffer pool are inactive. 
If the buffer pool is privates the file control 
structures for the hates assiqned to the buffer pool 
are deleted. : : 
The buffers. and buffer pool control structures are 
then deleted. : 
ss 
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2 2.2 Eile Reservation. functions 


22. 2. 1 Eile Reservation Command Block cence) 
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The FRCB is enpue to the Reserve and Saaue File Functions 


35 


<a i“ ds aps ak iS sma: agua ae gg iu Ss tp els _— aD 6 OD. a SS 688 a Cr a eet 6 SO OD -. @ -  --e. - -ee eee 


iP Re 


IMS. 


| A AD A A ~E  ED D D  A - ED DE NS SD AD A a ED EN - D  D AED -ED D - D -  -  ~ -D D  -E- D -P a -- | 


| 
1 


I 


| Ae SED S.  -D D D -D -S  :  -ree - ~<a <a a ss @ - -. - s - - es  ~- es  -. e . ee. a ee - ~ | 


; ‘ 


| FRLFLG 


FRARST.. 


FR. 


Ios he AR. ee ee RES 


BPN 


I 


. “ 


FR 


oo! IM . 


| OP a ee <-> ee 2 ~~ a - .  . -  e <- ee  e - - - -~ - - e : - eeeee | 


[. 


RFU 


Figure 1.2-2.. 


FRLIMS 


FR.ORS 


FRILFI 


FRUFI 


FRIFLG 


FRARST 


Immediate Status 
Original Status. 
Local File Identifier 


SCT address. (1 word) 
sector number of FD. (1 sores: 
Unique File Identifier (2 words) 
date and time 


creation 


Flags. (9 


FLRSHR 
F.RBEF 
F.RAFT 


FLRDUP 
F.RPRM 


F.2RADF 


F.RBOF 


=O 


=5 


e 06 Qn s0 oo 96 80 we. 


ss. 


bits) 


if one 
-If ons 
if ons 
if ons 
if one 


: MEZ 


Tf One 
if ones 


file 


file 
file 
file 
file 


copy 
copy 


File Reservation Command Block 


(2 words) 


is Sheree ts 
1s 
is 
1s 
1s a permanent fite 
A of 
B of 


Reservation. type (9 bits) 

no concurrent access 
exclusive access at file ‘tevel 
shared access at file level 


=0 
at 
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jap Reate file 
duplicate file 


protected by before err err 
protected by after journalization 
protected by duplicate file 


is defective. 
is defective 


q =3 shared access to files both shared and exclusive 
6 access to CI's , 7 | | 
a =4 shared access to files shared access’ to CI'‘'s 
_— =5 shared access to files, exclusive access to CI's 
FR.CIS Controt Interval size in words ° 
FR.BPN Buffer Pool Name. (3. words) . Bije a 
FRITIM Timer value to be used when reserving éhe file: In units 


of 1/64 mitt ueecoogs 


aia? 


A 2.2.2 Reserve. Eile. A<D23E42 
This piaeeiee crested a structure which describes the files 
allocates a Resource Control Block for the file (Cif under 
concurrent access. control)s and enqueues or reserves the 
file for the specified process. This . function must be 
executed for a cataloged disk file before that file can be 
opened. Other files will be “reserved” as part of the Open 
File function. ; 


format 
ICLIMB OM. OPCr1 oDRSF. F -EAXO 


Parameters | eo ee ; | | - ae 
~ descriptor 0 3 frames the File Reservation Command 8lock (CFRCB) | 


File Reservation Command Block <FRCB) Parameters 


ioout 2 we os ss 


FRLLFI Local file identifier 
FRIUFI Unique file identifier 
FR.LFLG Flags 
FLRSHR sharable 
F.LRBEF before journal 
FLRAFT after journal. 
FLRDOUP duplicate file 
FLRPRM. permanent file 
FLRADF . copy A defective 
FLRBOF © copy 8B defective 
FRIRST Reservation type ; ot 
FRLCIS CI sizes if zeros this parameter must be supplied 
to the Open File function. 
FR.BPN Buffer. Pool Name, if zero a buffer Aor will be. 
chosen automatically when the file is opened. 
FRITIM Maximum Length of time the process is willing 
to wait for the concurrent access reservation. 
Qutout : 7 3 
FRLIMS Immediate Status 
FRLORS Original Status 
Status Codes. 
1 invalid buffer pool name 
2 tite already. assigned to different buffer sail 
3 space for control structures not available 
4 concurrent access conflict (after waiting for FRI TIM) 
5S already reserved by this peo Sees ne a different 


reservation type 


6 file is not a cataloged Anse file 
search for the file structure 1s made based on 
FR.LFI and 


FRLUFI. If not founds, the file structure 
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: ae created ands if concurrent access is desireds a 
Resource Control. Block ts attocated for the file and 
the fite is reserved (RCB8 is enqueued). | 


If FR.BPN is Specifieds then the file is associated 


with the buffer pool with the specified name. 


\ 
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— 2. re 3 Remove File. (DRME LED 


This. Aiegeeon removes as file from ve nesecvetion list for 
the calling process. It is called at process termination 
for all files reserved or attlocated by the process. This 
function must be preceded by a Commit function. 


Format: | 
ICLIMB DML OPC,1, DRMF. F pEAXO 


Parameters i 
- descriptor 0 : frames the FRCB 


file Qeeepvarion: Command glock (FR CB B). _Parameters 


‘Inout | fe ? 
FRILFI Local file identifier 
FRIUFI Unique file identifier 

Qutput 2 
FRIIMS Immediate status 
FR.LORS Original status 


Status Codes 
4 File not found 
2 File stilt open 


oe Function 


A search for the file structure 1s made based on FR.LFI and 
FRLUFI. The count of the outstanding reservations against 
the file is decremented ands if zeros the Resource Control 
Block is deallocated and the fite structures deleted. 

wy 


~ 203 Qpen=Close File Functions 


tence 


2.3.1 OQpen-Close Command Block (ope) 


The OPCB is tnput to both the Open and Close File functions. \ 
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0... a ee ee oe 


ae . es 
eS ap an 22 ap. aD <2 4) 2p ~~ Oo Oh a aes. - -eeD an a a <n a ee of 22 om ~~. 2D 22 @e << 6 ee > oe ep oe <-> <b em - ee 


{ a tee Gee toe OP IMS : |  f 


| a op ORS. | | a ! 


I | .. «= QP,DOM ... . 2 os OP .LVL | 


| SD ED EE ED ED ED ED ED ED D-DD SE SD I ED ED ED SD SI -SD.s - . ED «.D “ - -S  s- -  e < - Se  D .  - - ~  - - - “< s  ee e | 


{ ~ | re dt nk 7 .REU | | | 
| i ili ci a i a a a a a la cl ace i al a 8 a cc “ce cap cos cus “lle soa oe | 
| | | : { 
| ACCESS | 
METHOD. 
SPECT FIC 


a «=D «oe ewe 


Figure 1.2-3. Open~Close Command Block 


OP.IMS Immediate Status 
OP.ORS Original Status. - 4 
OP.DOM Desired access method domain 
=1 Buffer Management 
=? UFAS | 
=3 Ids 
=. Before Journal 


_OP.LVL Level of Access 


= process. 
=1 work station 
=? system 


Words 4 - k of the OPCB are defined based on the access 
method chosen by specifying OF .D0M.. 
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o\ 223.2 Qpen File CROPN.FD 


Fe get 


"Metin % 


The Open File function creates and initializes a file access 
domain through which the caller can access the file. The 
particular type of domain . depends on the access method cho- 
sen through specification of OP.DOM. 


Eormat me emt 8S 
ICLIMB DMLOPCensDOPN.F-EAXO 


where n = the number of descriptors passed on the Argument /Paramete 


stack : 
Parameters 

- descriptor 0 
- descriptor 1 


frames the OPCB 

frames the identifier of the calling 

| | domain : , 
- descriptor 2 : frames an area of the caller's domain where 
the Open Fite function will store an entry 


descriptor (T=11) to the created file access 


, 3 - domain | | | 
- descriptors 3-n 3 Access Method Specific 


322.1 Buffer Management Qoen 


‘ 
4 


The Buffer Management Open is selected by setting OP.D00M = 1, 


\ Parameters ere Ae | : a 
‘No additional. descriptors on the- Argument/Parameter 
Stack are required by Buffer Management. 


Buffer Management Soecific_OPCB_ for Ooen rs, 
: In addition to the four words defined for the OPCB in the general Open 
File functions Buffer Management requires the following: 


Gee 2 reseOre. & + 18 7 35 
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Figure 1.2~4, Buffer Management Specific Section of 
OPCB for Open 


Ocen-Close Command Block (OPCB) Parameters 
Inout | 


BO.FC File codes 8 ASCII characterss Left justifieds. blank f 
BO.FLG Flags : | | | 
BeOSEQ -0 if ons file 1s sequential 
B.OSET -1 if ons file ts member of file set 
B.O08R -2 if ons buffer reservation is to be deferred 
BO.CIS Control Interval size in wordss 
have been input via the Reserve File function 
BO.NBF Number of buffers desired for this file set 
BO.MLK Maximum number of buffers that can be locked at any 
| one point in time for this file set 
BO.NCI Number of CI's per buffer | 
J | | BO.FST File set identifiers input only if this file is a 
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~ ss member of a file set (B8.OSET=1). When opening the 
s first file of a file sets this parameter should 
be zero. It will be returned as an output parameter. 


Qutgut 


BO.FID File identifiers this parameter is required input. 
| to other Buffer Management functions when the file 
1S a member of a file set. 

BO .FST File. set identifier; this parameter 15 peaudeed: 

input. to some other global Data Management functions 
: BO. cis Control Interval sizer if zero on inputs, the correct, 
vatue for CI size will be returned. 
Function 


1. If the file has already been opened by this users 
increment the count of the number . of opens for this 
user and return the entry descriptor to the existing 
Buffer Management domain. 


2s Search for the Peripheral Allocation Table (PAT) 
based on the input file code. Construct a tocal file 
identifier from the SCT address and sector number of 
the FD from the PAT. Find the file structure created 
by the File Reserve functions if cataloged disk file. 
If temporary file or tapes create file structure by 
executing Reserve File function. 
3. If the file has not yet been assigned to a buffer 
pools» then find a poot with buffers of the correct 
size. If one cannot be founds create a new buffer 
pool. 


4. If deferred buffer reservation is not desired 
(BLODBR=0), then reserve the desired number of 
buffers for the file. : 


5S. Return and.entry jee ess to the Buffer Manage- 
ment domain for this file. 
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Staal 


To be defined. 
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To be defined 
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(3-2-4 Before Journal sosci 


To be defined. 
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303 Close File (pcis.£) 
. The Close File function terminates the usage of a file 


access domain. The domain is deleted so that the file is no 
longer accessible through it. 


Eormat Sle ale bee & 
ICLIMB DM.OPCsnsDCLS.F/EAXO 


where nis. the number of descriptors passed on the 
Argument/Parameter stacks 


Pacameters 

- descriptor 0 : frames the OPCB 

- descriptor 1 : frames the domain identifier of the caller 

- descriptor 2: frames the entry descriptor of the file access 


| domatn returned by. the Open File function 
~ descriptor 3 = m: access method specific 
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3-3-1 Buffer Management Soecific Close 


The Buffer Management Close is selected by setting 
OP.DOM = 1. 


\ 


Parameters ie week | or ae - 3 a ee 
No. additional descriptors are required by Buffer Management other 
the three passed on the Argument/Parameter stack described in the 
general Close File function. 


Buffer Management Specific _ OQPCB_ for Close 
The following access method specific portion of the Open-Close 
Command Block is required by Buffer Management. 
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Figure 1.2-5. Buffer Management Specific OPCB for 


Close 
OPCB_ Parameters 
logout 
BO.WFC File codes 8 ASCII characters, Left justifieds blank 


BO.FID File identifier-s returned by the Open File function 


Function 


1. Search for Buffer Management file access domain based 
on anput file code (BO.FC). Check the input entry 
descriptor for validity. : 


Ce Decrement the number of times this domain has been 


opened. 


If zeros then flush the buffers and detete the 


local user-related structures. 


3. If all files of the file set have been closed» release 


the buffers and delete the Buffer Management domain. 
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& Quffec Reservation Functions 
ro4.1 Reserve-Remave Buffers Command Block. (RBCB) 


This block is input to both the Reserve and Remove Buffers 
functions 


0. A Gosh pee! GN eles ge GS ee | 35 

nn a | 7 “RBJIMS. | = | 
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1 4 | | RA LORS. | | 
2 | | | . RB.FST | 

| | ---------- -- +--+ + + + + ++ + + 5 + + + = === | 
3 f RB UNBE _ RB MLK 
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Figure 1.2-6. Reserve-Remove Buffers Command Block 


RB.IMS Immediate status 

RB.ORS Original status. 

RB.FST File set identifier 

RB.NBF Number of buffers desired for the file set 

RB.MLK Maximum number of buffers that can be locked 
at any one time for the file set 


wigan” 


4-22, 


| 


Nee 2 Reserve putters. _{DRSB46) 


This funceven reserves or ai tees the required number of 
buffers from the buffer pool for a given file set. This 
function is designed to be used when the “deferred buffer 
reservation” option of the Open File function is specified 
at Buffer Management levet. 


format 

ICLIMB DML OPC, 1,DRSB. FPEAXO 

Parameters a oh | 

- descriptor 0 : frames the RBCB 

RGC3_Parameters 
Inout 
RBIFST File set identi fier for which the buffers are to 
be reserved- returned by the Open File function 

RB.NBF Desired number of buffers for the file set. 
RB.MLK Maximum number of buffers that can be locked for 


the file set. 
Outout 7 3 
RB~IMS $$-Immediate status 
RB.ORS Original status 


Status_Codes a... 4 | 
4 invalid fite set Seenorn ee 
2 buffers not available 
Eyoctioo 


1. If the tnput values. for RB.NBF and RB.MLK are greater 
than those previously specified (via an Open File function 
or another Reserve Buffers function)» then use the input 
values. 


Ce If the required number of. buffers has not yet been 
reserveds then decrement the "available number of buffers” 
count for the. buffer poole if necessary creating new 
buffers up to the maximum number of buffers for the buffer 
pool. 


> 3. If the required number of buffers are not availables 
wait the process on a semaphore associated with the buffer 


pool. If the buffers are still not avaitable after a 
pre-determined elapsed times then return an error to the 
caller. an 


4. When the file is accessed via the Get Control Interval 
(GETCI) function of Buffer Management and the buffers have 
not yet been reserveds Buffer Management will call this 


7 eran ad 


function to reserve the number of buffers specified when 
the file was opened. 


A 244.3. Remove Buffers (DRMB.F) c- 

a ) : | 7 | | 

| This function removes buffers from the reservation list and 
returns them to the buffer pool as avaitable buffers. 


Format re 2 
ICLIMB DM, OPC ,1+DRMB.F-EAXO 
Parameters ..% 2. Sed eed e 
-descriptor 0 : frames the RBCS 
RBCB_Paramters 
Inout 


RB.FEST File set identifier 


Qutout pe 
RB.IMS Immediate status 
RB.ORS Original status 


Status Codes. 
ns invalid file set eer re 
2 buffers have not been flushed 
Function 


The buffers that — een pesehued pee the specified ee 
set are returned to the buffer pool as available buffers. 


bess 


2.5 Globat_File Functions 


2e5e! Global_Eunctions Command Block (GEC) 


i (oe os _ GF.IMS | 
| OED ED <P ED ED ED. D-DD a Oe ae RE A ED D-DD ED a <n -  -  -- a <  - - ~  - ee - | 
—— : | GF.ORS | 
| e-Th a -ab > OR aD 4D Oe OD OD a Oe 6 ee ee SO eS o-oo ~~ OO  -6 - < s  « e -. een- ee | 


i . GF.LFLG = 18 | GFeLVL { 


\ 
\ 
\ 
\ 


at Figure 1.2-7. Global Functions Command Block 


GFLIMS Immediate Status 
GF.ORS Original Status 
GF.FLG Flags SY a . 8 7 
GeFOLC -0 Detete Suffer Currencies. 
GeFPJR ~-1:. Physically journalize after Images 
GF.LVL Access. level 


=Q process 
=4 work station 


=2 system 


2.5.1.1 Glopal_ Flush (hGFL.F) 


This function flushes all buffers of alt open files at the 
specified access level. If the "delete buffer currencies" 
flag is sets each access method will be called to destroy 
Its copy of the buffer currency. 


4 
\ 
‘ 


Format : Sg ee 
ICLIMB Pree gue mares racine 


et Parameters 
- “descriptor 0 : Peanes the GFCB 


GFCB_Parameters ‘ 
Inout : 
GF.FLG Flags : a oi 
GeFDLC detete currencies 
GeFPJR Physically journalize after images 
GFeLVL Access Level | 
Qutput . 3 7 
GF.IMS Immediate status 
GFLORS Original status 


Euyoction 


For each open file at the soecified level the following 
functions are performeds ; 


a. the access method domain 1s called to destroy yts copy 
of the buffer currencies 


be. the buffer management ‘domain 1s called to flush the. 
bufferss specifying the two input flags G.FDLC and 
GeFPJ R. : 


ce if the currencies are to be deleted (G.FDCL=1),. then 
the Reservation Entry associated with this file is 
released, thus allowing use of the file by a different 
process. 


Se ABRIL EAE IE OE oy BET GeO FL RE 


A 24522 Global_Close_(DGCLs£) 


This function flushes. the. buffers and closes all fites that 
are open at the specified access level. 
emat a 
ICLIMB OML OPC o1eD0GCL.F eEAXO 
Parameters | a 
-descriptor 0 : frames the GFCB 
GFC8_ Parameters : ; 
Lnagut 7 . _ 
GFLLVL Access level 
Quteut So z 

GF.IMS Immediate status 

GFLORS Original status 
Function : | | | 
For each file that is open at the specified access levels 
the corresponding access method domain is called to close 
the file. 7 


fy t0905 Global _ Reset Currencies. (COGRC. FD 


anne Ei 


: This function catls each access method domain for each file 
‘ that is open at the specified level to reset the record and 
buffer currencies. The buffers for each file are also 
flushed. a 
ICLIMB DMLOPC/1e0GRC.FeEAXO 
Parameters fe Be Ae | 
- descriptor 0 : frames the GFCB 
GECB_ Parameters 
Loout oe 
GF.JLVL Access tevet 
Qutout ec 
GF.LIMS Immediate status 
GF.ORS Original status 
Function ay he oo 3 , Ee gs: Ske 
For each file at the specified access level that 18 open, 
the following functions are performeds 
a ae the access method domain for the. fite 1s called to 
ae reset the record and buffer currencies 
b. the buffer Management domainis. called to flush the 
bufferss specifying that currencies are to be deleted. 
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~ 205.4 Global _ Suspend File Usage 
To be defined 
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2e6e1 Lille Information Control Block CFEICB) 
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| 
t \ FI .UFI | 
| . 
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1 
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OO | he Fs a ee fae a | oe 35 


> SD a aD <a SD OP SD ee OD << OP OD 2D 2-6 SSD. a4 2 SD aD aD e® -~<D CO OD 62. aD OPS 8 2D SD SD OD OD -- * -* -S.  - - - GE. oD a -. e428 


t - we | — FILIMS | | 


| SPD ED OD ED DE 8. ED | SO SD OD OD 8 ee Ss OS  - -  -  - ee  - . . - s  - --  - -  :  .e e { 


| Ce) eto we ae 2 FILORS : , 


‘ I. SD ED ED: ED ED EE  -D  D, S aD SD - 8 ED ~ - D  D «-  - + 0  -  -  e - - - - ee { 


t |  FILTYP a - RFU 4 
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Figure 1.2-8. File Information Control Block (FICB) 
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— 
2.6.2 Returo- file Information (peel. £) 
This. . Puneet en peeurie iaeoeasetan about the file that is 
maintained in the. Globat Data Management domain. Five versions 
of the function govern the specific information returned as well 
as the manner of itdentifying the file on input. 
Format be | 
ICLIMB DOM.OPC,.1-ORFILFeEAXO 
Parameters we : 
- descriptor 0 : frames the FICB 
FICB Parameters 
Toout 7 | aes, : 7 : 
FI.LTYP Function. types this parameter determines 
which version of the function is executed: 
=1 FILFC is input 
Groups IsIIeIII-IV are suenut 
: =2 FI.LLFI 3S Input 
a 3 Groups IIsIII are output 
— =3 FILLFI is input 
oe Groups IsII~lII-V are output 
- =4 FILUFI is. input | 
Groups IIeIV are output 
=5 FILUFI is input , 
i Groups IeIIeIV-~V are output 2 S38 
FILFC. File codes eight ASCII characterssa Left justifieds blank fille 
FILLFI Local file identifier; 
SCT address. (1 word) 
sector number of FD (¢€1 word) 
FILUFI Unique file identifier (2 words) 
Qutout 8 5 es ‘ 
FILIMS Immediate status 
FI.ORS Originat status 
| Grove I. (File Usage Information) 
FI.LRST Reservation type (9 bits) 
FILRE Reservation Entry for file 
FI.FUS File Usage State 
FLIRSF =-0 if ons file has been poekeyed 
FLIOPN -1 if ons file has been. opened 
FLIFST ~2 if ons file is a member of a file set 
FLIEOF =~3 if ons the file is a sequential file and the 
| , current position is at the end of file 
on F.IEOV -4 if ons the file is a tape file and the 
PF | — current position is at the end of volume 
ze | | 


a, © = Sess 
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FLIURE <5 if ons» an Daeecouerab te: error Has been encountered 


FILFID Buffer Management file identifier 
FILNBF Number of buffers desired for file set 


FILMLK Maximum number of buffers that can be locked 
7 7 at any one time \ ye 4 os 
FILFST Buffer Management file set identifier 

. Group II (File Information? 
FI.LRCB Resource Control Block associated with file 
FI.CIS Control Interval size | 


FILATR File attributes | Me 
FLISHR -0 if ons file is sharable 


F.LIBEF -~1 if ons file is protected by before journalization 
FLIAFT ~-2 1f ons file Is protected by after journalization 
F.IDUP =-3 1f ons file is protected by duplicate file 
—F.LIPRM -4 if ons file is permanent | 

FLITAP=5 if ons file is assigned to tape 

6-8 RFU - | | _ 


FLIADF -9 ~ if ons» copy A of duplicate file is defective 
FLIBDF -~-10 if one copy 8 of duplicate file is defective 


FI. NCI Number of Control Intervals. per buffer 
FI.BPN Buffer pool name assigned to file 


FI.CFZ Current file size (in number o f CI*s) 
| Grouo_lll 7 4 | 
FILUFTI Unique file identifier (2 words) 
Group_ ly. | . 
FI.BLFI Local file Sueatae tet C2 someden 
: Gcqugo_V 
FI.LFC File code 


Funeria on oe | oy: 

Depending on ene type ae request (€FI.TYP), the caller identifies 
the file by inputting either the file code CFI.FC). the Local 
file identifier (CFISLLFI)«s or the unique file identifier CFI.LUFID. 


Information about the file and about the usage of the file by the 


current process 1s returned in the FICB8. 
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